home *** CD-ROM | disk | FTP | other *** search
/ 130 MIDI Tool Box / 130 MIDI Tool Box.iso / midi2rol / mf2rol.doc next >
Text File  |  1991-04-06  |  4KB  |  104 lines
  1. MF2ROL - A MIDI file to .ROL file converter.
  2.  
  3. Beta V1.0 uploaded originally to the Natl.PC & MIDI Data Bank BBS (708) 593-8703
  4. This package should include the following files:
  5.  
  6. MF2ROL.DOC        This file.
  7. MF2ROL.EXE        MIDI File to AdLib .ROL file converter.
  8. LISTBNK.EXE        AdLib instrument bank (.BNK) listing program.
  9. BNK835.BNK        Instrument bank file referenced by all the .CFG files below
  10. PANAMA.MID        Sample MIDI file from BENOIT.ZIP on this BBS.
  11. PANAMA.CFG        Config file suitable for PANAMA.MID
  12. FANTASIA.MID    Another sample MIDI file from LUTE.ZIP
  13. ROOTBEER.MID    Another sample MIDI file from PIANSOLO.ZIP
  14. STYX-32.MID        Another sample MIDI file from STYX-32.ZIP
  15. DEFAULT.CFG        A simple config file.
  16. MT32.CFG        A very incomplete config file to emulate an MT32
  17. MT32INS.CFG        Same as above but with no percussion
  18.  
  19. The author wrote MF2ROL and LISTBNK at home, for his own personal use.
  20. Since many AdLib and SoundBlaster owners may find these programs useful,
  21. they are being released to the user community. However, the author retains
  22. ownership of the programs, and they may not be sold for profit. The package
  23. may be distributed freely, but the contents should not be altered in any
  24. way including this document. The user is responsible for determining that
  25. these programs are suitable and safe for use on his/her system.
  26.  
  27. MF2ROL -
  28.     This program converts MIDI files to .ROL files. This beta version
  29.     processes note, program (patch/timbre) and tempo information and
  30.     ignores pitch-bend and volume (pressure). Maximum number of events
  31.     processed is about 6400. To convert a MIDI file, simply specify it in the
  32.     command line, for example:
  33.  
  34.         mf2rol music.mid
  35.  
  36.     This will create the file called music.rol in the current directory.
  37.     The conversion may be dull however because the converter assumes all
  38.     notes should be played with the instrument "PIANO1". To control what
  39.     timbres (instruments) are used, you may specify a configuration file
  40.     as a second argument to the program, for example:
  41.  
  42.         mf2rol music.mid default.cfg
  43.  
  44.     In this case, the converter will use the information in the config
  45.     file to assign instruments to patch numbers, tracks or channels.
  46.     The config file specifies a instrument bank file to use, percussion
  47.     mode in addition to the timbre assignment rules.
  48.     Examine the sample config files for documentation.
  49.     You will certainly want to develop your own config files to emulate
  50.     the more popular synths. Some knowledge of MIDI would be handy.
  51.  
  52.     To convert the sample MIDI files in this package to ROLs, use
  53.     the following commands:
  54.  
  55.         mf2rol panama.mid panama.cfg
  56.         mf2rol fantasia.mid default.cfg
  57.         mf2rol rootbeer.mid
  58.         mf2rol styx-32.mid mt32ins.cfg
  59.  
  60.     When you play the ROLs, remember to tell your player to use BNK835.BNK.
  61.     The converter uses a dynamic allocation method to assign sound-card
  62.     voices to individual notes. If there are more simultaneous notes
  63.     in a MIDI file than there are voices, the program cuts off the oldest
  64.     notes currently playing. Thus, if you convert MIDI files that have
  65.     very many simultaneous notes playing, the resulting ROL may sound
  66.     choppy. Take note that many profesionally sequenced files DO
  67.     use a LOT of notes. The styx-32 sample is included to illustrate
  68.     this effect.
  69.  
  70.     Known problems:
  71.         1) Memory limit - will not convert very large MIDI files.
  72.         2) Zero-length notes - The program specifies 24 ticks per
  73.             beat in the ROL file while MIDI files usually go between
  74.             100 and 200 ticks per beat. Very short notes get trucated
  75.             down to zero length and get left out of the ROL.
  76.  
  77. LISTBNK -
  78.     This program lists the contents of an instrument bank file.
  79.     For example, to list the contents of BNK835.BNK use the command:
  80.  
  81.         listbnk bnk835.bnk
  82.  
  83.     This will list the instruments to the screen. To save into a file
  84.     or to print, use:
  85.  
  86.         listbnk bnk835.bnk > bnk835.lst
  87.         listbnk bnk835.bnk > prn:
  88.  
  89.     A listing of the contents of your favorite instrument bank file
  90.     is handy when creating your own config file.
  91.  
  92. -------
  93. I hope you find these programs useful as I have. Remember that this
  94. is the very first version of these programs. Since they are basically
  95. free, please do not expect support. I am willing to take bug reports
  96. however. If you do develop a complete config file for the MT32, I'd
  97. appreciate a copy.
  98.  
  99. -Alejandro Kapauan (on this BBS)
  100.  aak@iexist.att.com (internet)
  101.  hdtx51a (Prodigy)
  102.  4/6/91
  103.  
  104.